.\" Man page generated from reStructuredText.
.
.TH "RBD-GGATE" "8" "Mar 12, 2022" "dev" "Ceph"
.SH NAME
rbd-ggate \- map rbd images via FreeBSD GEOM Gate
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH 提纲
.nf
\fBrbd\-ggate\fP [\-\-read\-only] [\-\-exclusive] [\-\-device \fIggate device\fP] map \fIimage\-spec\fP | \fIsnap\-spec\fP
\fBrbd\-ggate\fP unmap \fIggate device\fP
\fBrbd\-ggate\fP list
.fi
.sp
.SH 描述
.sp
\fBrbd\-ggate\fP 是一个 RADOS 块设备（ rbd ）映像的客户端。它会把一个 rbd 映像映射到 ggate （ FreeBSD GEOM 网关类）设备，这样就可以像访问普通的本地块设备一样访问它了。
.SH 命令
.SS map
.sp
派生一个进程用于创建 ggate 设备，然后在 GEOM 网关内核子系统和
RADOS 之间转发 I/O 请求。
.SS unmap
.sp
销毁 ggate 设备，并结束负责它的进程。
.SS list
.sp
罗列已映射的 ggate 设备。
.SH 选项
.INDENT 0.0
.TP
.B \-\-device *ggate device*
指定 ggate 设备路径。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-read\-only
以只读方式映射。
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclusive
禁止其它客户端写入。
.UNINDENT
.SH 映像和快照格式
.nf
\fIimage\-spec\fP is [\fIpool\-name\fP]/\fIimage\-name\fP
\fIsnap\-spec\fP  is [\fIpool\-name\fP]/\fIimage\-name\fP@\fIsnap\-name\fP
.fi
.sp
.sp
\fIpool\-name\fP 默认为 rbd 。如果一个映像名内包含斜杠（ / ），就必须加 \fIpool\-name\fP 。
.SH 使用范围
.sp
\fBrbd\-ggate\fP 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 \fI\%https://docs.ceph.com\fP 。
.SH 参考
.sp
rbd(8)
ceph(8)
.SH COPYRIGHT
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" Generated by docutils manpage writer.
.
